home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / source / snip9503 / lld_blob.h < prev    next >
Encoding:
Text File  |  1995-03-14  |  2.6 KB  |  54 lines
  1. /* =======================================================================
  2.     LLD_BLOB.h      Generic Doubly Linked List for Binary Large OBjects.
  3.                     Linked Lists for variable size data-items.
  4.  
  5.                     v1.00  94-08-11
  6.  
  7.                     - Based on the LLD module for fixed size data-items.
  8.                     - Use the functions in the LLD module for operations
  9.                       not specific to Blobs. You can use LLDnodePtr() to
  10.                       obtain a pointer to the stored Blob.
  11.                     - Note that From and To suffixes to function names are
  12.                       implied in the Blob data related functions.
  13.  
  14.  _____              This version is Public Domain.
  15.  /_|__|             A.Reitsma, Delft, The Netherlands.
  16. /  | \  --------------------------------------------------------------- */
  17.  
  18. /* ---- LL blob system management and maintenance --------------------- */
  19.  
  20. int  LLDblobCreate( void );
  21.                         /* returns list number to use or -1 on failure. */
  22.                         /* MUST be called before using a list of blobs. */
  23.  
  24. /* ---- Node management --------------------------------------------------
  25.    Functions changing current node pointer to the new node.
  26.    A return value of -1 indicates a memory allocation problem.
  27. */
  28. int  LLDblobInsert( int List, void * Source, unsigned Size );
  29.                                           /* insert BEFORE current node */
  30. int  LLDblobAdd( int List, void * Source, unsigned Size );
  31.                                           /* insert AFTER current node  */
  32.  
  33. /* Functions NOT changing the current node pointer.
  34.    Especially intended for implementation of Queue's and Stacks.
  35. */
  36. int  LLDblobPrepend( int List, void * Source, unsigned Size );
  37.                                                 /* insert as first node */
  38. int  LLDblobAppend( int List, void * Source, unsigned Size );
  39.                                                 /* insert as last node  */
  40.  
  41. void LLDblobDelete( int List );
  42.         /* remove current node and free() the data.                     */
  43.         /* current node ptr moved to next node. UNLESS the deleted node */
  44.         /* was the last node: then current ptr moved to previous node   */
  45.  
  46. /* ---- stored data management -------------------------------------------
  47.    'return' typeless data. The return value is the size of the data.
  48.    The data is transferred to Destination.
  49.    If 'Destination' is NULL, the only action is returning the size.
  50. */
  51. unsigned LLDblobData( int List, void * Destination );
  52.  
  53. /* ==== LLD_BLOB.h  end =============================================== */
  54.